Получение результатов поиска
Запрос позволяет получить результаты поиска по идентификатору поиска.
Синтаксис запроса
POST https://b2b-api.go.yandex.ru/integration/integration/v2/avia/flights/search-results
Заголовки запроса
Authorization: Bearer <OAuth-токен>
Процесс получения токена описан в разделе Начало работы.
X-YaTaxi-Selected-Corp-Client-Id— идентификатор клиента из личного кабинета. Обязателен, если по токену доступно несколько клиентов.
Тело запроса
Данные передаются в формате JSON:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Идентификатор запроса поиска. |
Строка |
Да |
|
|
Фильтр по авиакомпаниям. |
Массив строк |
Нет |
|
|
Фильтр по аэропортам отправления. |
Массив строк |
Нет |
|
|
Фильтр по аэропортам прибытия. |
Массив строк |
Нет |
|
|
Количество пересадок от 0 до 10. |
Число |
Нет |
|
|
Фильтр по цене. |
Объект |
Нет |
|
|
Без ночных пересадок. |
Булево |
Нет |
|
|
Без смены аэропорта. |
Булево |
Нет |
|
|
Поле сортировки: |
Строка |
Нет |
|
|
Направление сортировки: |
Строка |
Нет |
|
|
3D-контракт. |
Булево |
Нет |
Структура объекта prices:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Минимальная цена. |
Цена |
Нет |
|
|
Максимальная цена. |
Цена |
Нет |
Описание полей ответа
В ответе могут содержаться следующие поля:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Статус поиска: |
Строка |
Да |
|
|
Время, до которого актуальны результаты поиска. |
Строка в формате даты и времени |
Нет |
|
|
Диапазон цен в результатах поиска. |
Цена |
Нет |
|
|
Диапазон длительности пересадок. |
Продолжительность остановки |
Нет |
|
|
Цены по количеству пересадок. |
Массив |
Нет |
|
|
Список выбранных авикомпаний для фильтрации. |
Массив |
Нет |
|
|
Список авиакомпаний, доступных для фильтрации. |
Массив |
Нет |
|
|
Список локаций, выбранных для фильтрации. |
Массив |
Нет |
|
|
Локации, доступные для фильтрации. |
Массив |
Нет |
|
|
Список рейсов. |
Массив |
Нет |
|
|
Результаты поиска — маршруты с тарифами. |
Массив |
Нет |
Структура объекта prices:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Минимальная цена. |
Цена |
Да |
|
|
Максимальная цена. |
Цена |
Да |
Структура объекта stops_duration:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Минимальная длительность в минутах. |
Число |
Да |
|
|
Минимальная длительность в минутах. |
Число |
Да |
Структура объекта stops_prices:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Количество пересадок. |
Число |
Да |
|
|
Цена для этого количества пересадок. |
Цена |
Да |
Структура объекта airlines:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Код авиакомпании. |
Строка |
Да |
|
|
Название авиакомпании. |
Строка |
Да |
|
|
URL логотипа. |
Строка |
Да |
Структура объекта locations:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Код аэропорта. |
Строка |
Да |
|
|
Название аэропорта. |
Строка |
Да |
|
|
Код города. |
Строка |
Да |
|
|
Название города. |
Строка |
Да |
|
|
Код страны. |
Строка |
Да |
|
|
Название страны. |
Строка |
Да |
Структура объекта filter_locations:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Подтверждает, что это аэропорт вылета. |
Булево |
Да |
|
|
Код аэропорта. |
Строка |
Да |
Структура объекта flights:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Идентификатор рейса. |
Строка |
Да |
|
|
Номер рейса. |
Строка |
Да |
|
|
Код авиакомпании. |
Строка |
Да |
|
|
Модель самолета. |
Строка |
Да |
|
|
Название самолета. |
Строка |
Да |
|
|
Аэропорт вылета. |
Строка |
Да |
|
|
Время вылета. |
Строка в формате даты и времени |
Да |
|
|
Аэропорт прилета. |
Строка |
Да |
|
|
Время прилета. |
Строка в формате даты и времени |
Да |
|
|
Технические остановки. |
Массив |
Нет |
Структура объекта results:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Идентификатор маршрута. |
Строка |
Да |
|
|
Прямой рейс. |
Поездка |
Да |
|
|
Обратный рейс. Структура аналогична |
Поездка |
Да |
|
|
Тарифные варианты для этого маршрута. |
Массив |
Да |
Структура объекта forward_trip:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Аэропорт вылета. |
Строка |
Да |
|
|
Время вылета. |
Строка в формате даты и времени |
Да |
|
|
Аэропорт прилета. |
Строка |
Да |
|
|
Время прилета. |
Строка в формате даты и времени |
Да |
|
|
Общая длительность в минутах. |
Число |
Да |
|
|
Идентификаторы рейсов. |
Массив строк |
Да |
Структура объекта tariff_variants:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Идентификатор результата поиска. |
Строка |
Да |
|
|
Чартер. |
Булево |
Да |
|
|
Идентификатор багажа. |
Строка |
Нет |
|
|
Идентификатор ручной клади. |
Строка |
Нет |
|
|
Общая стоимость |
Цена |
Да |
|
|
Сервисный сбор. |
Цена |
Да |
|
|
Нужно ли запрашивать допонительные услуги. |
Булево |
Да |
|
|
Возвратный до вылета. |
Булево |
Нет |
|
|
Возвратный после вылета. |
Булево |
Нет |
|
|
Информация о политике путешествий. |
Информация о политике путешествий |
Нет |
|
|
3D-контракт. |
Булево |
Нет |
|
|
Информация об изменениях в тарифе. |
Варианты изменений в тарифе |
Нет |
Структура объекта change:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Изменения в ручной клади. |
Изменения в ручной клади |
Нет |
|
|
Изменения в багаже. |
Изменения в багаже |
Нет |
|
|
Изменение возвратности до вылета. |
Изменение возвратности до вылета |
Нет |
|
|
Изменение стоимости. |
Изменение стоимости |
Нет |
Структура объекта cabin_baggage:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Предыдущее значение. |
Изменения в полях багажа |
Да |
|
|
Текущее значение. |
Изменения в полях багажа |
Да |
Структура объекта previous_value:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Количество мест. |
Число |
Да |
|
|
Вес в кг. |
Число |
Да |
|
|
Размер в см. |
Число |
Да |
|
|
Описание. |
Строка |
Нет |
Структура объекта refundable_before_departure:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Название поля. |
Строка |
Да |
|
|
Предыдущее значение. |
Булево |
Нет |
|
|
Текущее значение. |
Булево |
Нет |
Структура объекта total_cost:
|
Поле |
Описание |
Формат |
Обязательность |
|
|
Название поля. |
Строка |
Да |
|
|
Предыдущее значение. |
Строка |
Нет |
|
|
Текущее значение. |
Строка |
Нет |
включая сервисный сбор